tempo-k8s docs - How to integrate with other charms over `tracing`
Setting up tracing integration
if you are charming an application that is already instrumented for tracing or you plan to configure the workload or the charm itself to push traces, you can integrate with tempo-coordinator-k8s
, the single integration entrypoint for Charmed Tempo HA, to send traces to a Tempo endpoint.
Instrumenting your workload
is not covered under tempo-k8s
. Some workloads, like Grafana
are already instrumented for tracing by design. Otherwise, you can use auto-instrumentation libraries to instrument your workload and integrate with tempo-k8s
as a tracing backend.
For an example of charms that already integrate with tempo-k8s
to collect traces, see loki
and prometheus
.
Add an integration endpoint to charmcraft.yaml
host and injesters data is communicated over relation data, where the charmed application is the requirer and Tempo charm is the provider.
For consistency across the ecosystem, it is encouraged to name the relation tracing
.
Edit your charm’s charmcraft.yaml
to add, under requires
, the following:
requires:
# any other requirers your charm supports
tracing:
interface: tracing
limit: 1
Fetch the tracing charm library
charmcraft fetch-lib charms.tempo_coordinator_k8s.v0.tracing
The TracingEndpointRequirer
object enables your charm to easily access Tempo endpoint information exchanged over a tracing
relation interface.
Use TracingEndpointRequirer
If you are intending to send traces with otlp_http
and otlp_grpc
tracing protocols:
from charms.tempo_coordinator_k8s.v0.tracing import TracingEndpointRequirer
class FooCharm:
def __init__(self, *args):
super().__init__(*args, **kwargs)
...
self.tracing = TracingEndpointRequirer(self, protocols=["otlp_http", "otlp_grpc"])
...
This will ensure that each unit of Foo
will have access to a Tempo endpoint to push charm traces to once a
relation is established.
For the list of supported protocols
, see Tracing Protocols.
Access Tempo endpoints
After instantiating TracingEndpointRequirer
with a list of protocols, tempo-k8s
charm will provide, as part of its databag, a set of Tempo endpoints for the requested protocols that your workload
& charm
can use to push traces to.
from charms.tempo_coordinator_k8s.v0.tracing import TracingEndpointRequirer
class FooCharm:
def __init__(self, *args):
super().__init__(*args, **kwargs)
...
self.tracing = TracingEndpointRequirer(self, protocols=["otlp_http", "otlp_grpc"])
...
# get tempo endpoints
if self.tracing.is_ready():
grpc_endpoint = self.tracing.get_endpoint("otlp_grpc")
http_endpoint = self.tracing.get_endpoint("otlp_http")
We recommend that you scale up your tracing provider and relate it to an ingress so that your tracing requests go through the ingress and get load balanced across all units. Otherwise, if the provider’s leader goes down, your tracing goes down.
Last updated a month ago.